Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Managing Paper Trays

GXGetTrayMapping

You can use the GXGetTrayMapping function to determine the current tray-mapping mode of the printer.

OSERR GXGetTrayMapping (gxTrayMapping *trayMapping);

trayMapping

A pointer to a value that, on return, is the current tray-mapping mode of the printer.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXGetTrayMapping function returns the current tray-mapping mode of the printer in the trayMapping parameter. If any of the paper trays has an assigned paper type, the value of trayMapping is set to gxConfiguredTrayMapping; otherwise, the value of trayMapping is set to gxDefaultTrayMapping.

You can use this function to determine if you need to loop through the paper
trays to find a certain paper type. If the returned value of trayMapping is gxConfiguredTrayMapping, you know that at least one of the trays contains a specific paper type and that you do need to loop through the trays. If the returned value of trayMapping is gxDefaultTrayMapping, none of the trays has a specific paper type assigned to it, so you don't need to loop through them.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The gxTrayMapping enumeration is described on page 5-13.

You can read about managing paper trays in the section "Managing Paper Trays and Their Paper Types" beginning on page 5-5.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help